home *** CD-ROM | disk | FTP | other *** search
/ Chip: 2005 Utilities / CHIP Utilities 2005 / CHIP Utilities 2005.iso / dosapps / freedos / help / emm386.en < prev    next >
Encoding:
Text File  |  2002-11-27  |  5.3 KB  |  176 lines
  1.         readme.txt for EMM386/HIMEM
  2.  
  3.     ***********************************************************
  4.     *THIS IS FREE SOFTWARE WITH ABSOLUTELY NO WARRANTY        *
  5.     *WHATSOEVER, WHICH YOU MAY USE COMPLETELY AT YOUR OWN RISK*
  6.     *                                                         *
  7.     *IF IT WORKS FOR YOU - FINE.                              *
  8.     *                                                         *
  9.     *IF IT DOESN'T - STOP USING, BUT DON'T COMPLAIN.          *
  10.     *                                                         *
  11.     *IF YOU SEND BUG REPORT'S, SEND DETAILS                   *
  12.     *I WONT'T EVEN LOOK AT BUG REPORTS LIKE                   *
  13.     *  'your EMM386 makes problems. can you help?'            *
  14.     *                                                         *
  15.     * FIXES WELCOME                                           *
  16.     ***********************************************************
  17.  
  18.     EMM386/HIMEM is released under the GNU GENERAL PUBLIC LICENSE, 
  19.     see the file DOCS\LICENSE.TXT for the full text. 
  20.     
  21.     In addition, the original authors copyrights must remain intact;
  22.  
  23.  
  24.  ********************************************************************
  25.  ****** this release requires FreeDOS kernel version >= ke2026 ******
  26.  ********************************************************************
  27.  
  28.  
  29. What it shall do:
  30.  
  31.     HIMEM.EXE  replaces MSDOS HIMEM.SYS,
  32.     EMM386.EXE replaces MSDOS EMM386.EXE
  33.  
  34.  
  35.  ****************  Why use EMM386   ****************
  36.  
  37. if you need Upper memory and your PC is not recognized by 
  38.     UMBPCI
  39.  
  40. if you want enhanced (EMS) memory
  41.  
  42.  **************** Why NOT use EMM386 ***************
  43.  
  44. if you want to run protected mode (VCPI/DPMI) programs,
  45. you can't run EMM386. to be done - much later.
  46.  
  47. Programs doing a LOT of IN/OUT may run slower in a protected
  48. mode environment like EMM386
  49.  
  50.  
  51.  ******  How to use it *******************************
  52.  
  53.  
  54.  
  55. change CONFIG.SYS like
  56.  
  57.     files=20
  58.     buffers=30
  59.     lastdrive=z
  60.     break=off
  61.     
  62. >>> dos=high,umb
  63. >>> device=HIMEM.EXE        
  64. >>> device=EMM386.exe NOEMS 
  65. >>> shellHIGH=c:\command.com /p /e:512
  66.  
  67. both HIMEM and EMM386 require PC's >= 80386 to run.
  68.  
  69.             
  70. *******************************************************
  71.  
  72.  
  73.  
  74. COMMANDLINE switches implemented
  75.  
  76.     use EMM386.EXE from commandline - it will tell you:
  77.     
  78.          NOEMS      - disable EMS completely (default=enable)
  79.          VDS        - enable  VDS current status is experimental
  80.          FRAME=D000 - select wanted pageframe(default=highest possible)
  81.          EMM=20000  - 20000 KB EMS memory wanted(default=8MB)
  82.          X=D000-D800 - no make memory mapped devices work
  83.  
  84.          I=A000-AFFF - IF YOU REALLY KNOW WHAT YOU DO (VGA graphics)
  85.          I=B000-B7FF - IF YOU REALLY KNOW WHAT YOU DO (Hercules)
  86.          I=BC00-BFFF - IF YOU REALLY KNOW WHAT YOU DO (VGA upper text)
  87.                             see WARNING below
  88.  
  89.          /VERBOSE    - give some more details about found devices, 
  90.                        mapped UMB's,...l
  91.  
  92.  
  93.     EMM386 allocates fixed amount of whatsneeded (from HIMEM.EXE)
  94.         needed internally ca. 96 KB for pagetables, high code,...
  95.         64K for DMA handling ( no idea if that works though)
  96.         additionally enough memory to map UMB's (16..160KB)
  97.     
  98.         + tries to allocate the wanted EMS memory (default=8MB) 
  99.         more to be used as EMS memory
  100.  
  101.     WARNING:
  102.         in theory, its possible to use upper memory at 
  103.         A000..AFFF (VGA graphics) and
  104.         B000..B7FF (hercules adapter)
  105.         
  106.         
  107.         however some programs (or the BIOS INT 10 functions)
  108.         seem to write _sometimes_ into this area,
  109.         so operating with this memory area 
  110.         
  111.             IS HIGHLY DISRECOMMENDED to use A000-B7FF
  112.             
  113.         use it at your own risk only            
  114.  
  115.  
  116. *********************   known BUGS ***************
  117. EMM386 seems to run stable.
  118. VDS support is only experimental
  119.  
  120. no VCPI/DPMS/DOS32 functionality
  121.     none at all - not even thought about that
  122.  
  123. *********************   troubleshooting ***************
  124.  
  125.  
  126. if you have problems 
  127. add /VERBOSE to EMM386 commandline, will give some details
  128. about XMS memory, UMB memory, blocks mapped,...
  129.  
  130. make sure you have kernel >=2026
  131.  
  132. 1'st) start with following CONFIG.SYS
  133.     !files=20
  134.     !anydos=1
  135.     !break=off
  136.     !buffers=30
  137.     !screen=0x12
  138.     !lastdrive=z
  139.     !stacks=0,0
  140.     !dos=high,umb
  141.     !shellhigh=a:\command.com /P /E:512 /MSG
  142.     
  143.     
  144.     DEVICE=\freedos\himem.exe
  145.     DEVICE=\freedos\emm386.exe NOEMS /VERBOSE
  146.  
  147.     rem - if you want CD:
  148.     rem DEVICE=\freedos\CDROM.SYS /D:MSCD000
  149.  
  150. 2'nd) add one driver after the other, until you find
  151.     the one, that causes trouble.
  152.     try to load it high (deviceHIGH=),
  153.     then to load low (device=),
  154.     then try to load BEFORE EMM386.
  155.     please report any *positive* results, so I can
  156.     add them here.
  157.     
  158. 3'rd) you are out of luck. sorry.       
  159.     
  160.  
  161. *********************   known incompatibilities ***************
  162.  
  163. FDXMS08
  164.     uses priviledged instructions and is not supported
  165.  
  166. FDXMS09
  167.     has a bug and is not supported
  168.     please use HIMEM.EXE, which is 400 byte smaller as well.
  169.  
  170. ***********************************************************
  171.  
  172.  
  173.  
  174. tom ehlert (tom.ehlert@ginko.de) 2002-04-03 
  175.  
  176.